Findリファレンスコンテンツフィード

このドキュメントは、商品フィードドキュメントとあわせて使用してください。

リファレンスコンテンツフィードには、レシピ、記事、ブログ、動画、その他コマースサイト上でインデックス化・検索対象となるリファレンスコンテンツに関する属性（メタデータ）が含まれます。Findは、コンテンツに関する説明、名称、カスタム属性などの属性をインデックス化・検索します。リファレンスコンテンツフィードは、標準の圧縮カタログフィードに含まれる2つ（リージョンがある場合は3つ）の個別ファイルで構成されています。更新の場合は、必ず完全なフィードを再送信してください。

このフィードは、単独で送信することも、商品フィードとzip圧縮して送信することも可能です。

フィードファイル

フィードファイル	詳細	ファイル名パターン
コンテンツフィード	Findでインデックス化・検索対象となるすべてのコンテンツのリストと説明。	content_full_sitename_YYYY_MM_DD.txt
コンテンツ属性フィード	各コンテンツの属性。各リファレンスコンテンツには、imageおよびlink属性が必須です。	content_attribute_sitename_YYYY_MM_DD.txt
リージョン完全フィード	リージョンが必要な場合は、次の仕様に従ってリージョン完全フィードを提供してください：https://help.richrelevance.com/Relev...ct_Region_Feed Note: リージョンを使用する場合、コンテンツに特化しない場合でもサイト全体のすべてのリージョンを提供する必要があります。	region_full_sitename_YYYY_MM_DD.txt

Note: これらのファイルは、Flat FileカタログフィードをAlgonomyに転送する際、zip圧縮時に含めることができます。

ファイル仕様

各ファイルの仕様は下記を参照してください。

ファイル内の区切り文字はパイプ（|）としてください。他の区切り文字が必要な場合は、Algonomy担当者にご相談ください。

予約語：

id

content_id

content_external_id

content_genre

content_genre_id

content_name

name

content_type（注: 値は "4" となります）

contentType

content_feed_date

content_start_date

startDate

content_end_date

endDate

content_recommendable

recommendable

content_findable

content_site_id

preview_url

previewUrl

コンテンツフィード

ファイル名: content_full_sitename_YYYY_MM_DD.txt 必須

Note: コンテンツは商品と同じIDを持つことはできません。商品とコンテンツには一意のIDが必要です。

名称	型	必須？	定義
id	ASCII	はい	このコンテンツの一意識別子。各コンテンツのIDは一貫して維持する必要があり、ランダム化してはいけません。 Note: idフィールドにはスラッシュ（/）は使用できません。
name	text	はい	コンテンツの名称（タイトル）。検索対象でもあります。最大255文字。デフォルトでこの属性はファセット、検索、フィルタ、保存可能です。
start_date	date	いいえ	日付のフォーマットはYYYY-MM-DDです。デフォルトでこの属性はファセット、フィルタ可能です。
end_date	date	いいえ	日付のフォーマットはYYYY-MM-DDです。デフォルトでこの属性はフィルタ可能です。
findable	Boolean	はい	Findリファレンスコンテンツ用のフラグ。Findでインデックス化する場合はTrueに設定してください。デフォルトはFalseです。
recommendable	Boolean	はい	falseに設定する必要があります。デフォルトはtrueです。

サンプル

- Findリファレンスコンテンツ（完全）

リファレンスコンテンツ属性フィード

ファイル名: content_attribute_sitename_YYYY_MM_DD.txt 必須

属性値（および複数値属性）は、カラムベースまたは行ベースのフォーマットで記述できます。ただし、ファイル内で混在することはできません。システムはヘッダーからフォーマットを自動判別します。

リストには、属性値に含まれず、ファイル内の他のリスト区切りとも重複しない区切り文字を使用してください。値にピリオドが含まれる場合はリストとして扱われます（これがデフォルト動作です）。ピリオドでリスト値が区切られます。ただし、フィードプロファイル作成時にリスト区切り文字をカスタマイズできます。

コンテンツ属性では、リファレンスコンテンツの属性（メタデータ）を指定します。カスタム属性は最大32,000文字まで設定でき、説明やその他情報もインデックス化・検索できます。

リファレンスコンテンツには、画像URL用とリンクURL用の2つの属性が必須です。画像のないリファレンスコンテンツは検索結果に表示されません。これらの属性には命名規則はありませんが、image_urlおよびlink_urlの名称はコンテンツ検索APIの設定時にサイト設定に追加されます。

カラムベースフォーマット

名称	型	必須？	定義
content_id	ASCII	はい	コンテンツファイルで定義したコンテンツの識別子 Note: content_idフィールドにはスラッシュ（/）は使用できません。
attribute.image_url	string	はい	名称は任意ですが、画像URLは必須です。"attribute" プレフィックスが必要です。
attribute.link_url	string	はい	名称は任意ですが、リンクURLは必須です。"attribute" プレフィックスが必要です。
attribute.[attribute key 1]	text	いいえ	カスタム属性
attribute.[attribute key 2]	text	いいえ	カスタム属性
...
attribute.[attribute key N]	text	いいえ	N番目のカスタム属性

サンプル

カラムベース形式によるコンテンツ属性フィードの基本例：

複数属性を指定する例（リスト値の区切りはデフォルトでピリオド、プロファイル作成時に変更可能）：

行ベースフォーマット

名称	型	必須？	定義
content_id	ASCII	はい	コンテンツファイルで定義したコンテンツの識別子 Note: ContentIDフィールドにはスラッシュ（/）は使用できません。
attr_name	text	はい	一意の属性キー
attr_value	text	はい	属性名
localization_type	text	いいえ	リージョンまたは言語
localization_value	text	いいえ	リージョンまたは言語の値。

サンプル

行ベース形式によるコンテンツ属性フィードの基本例：

複数の属性を別々の行で指定する例：

個別行で複数の属性値を渡す例（リスト値の区切りはデフォルトでピリオド、プロファイル作成時に変更可能）：

ローカライズ例（行ベース）